home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / gnu / mtools.lha / mtools-2.0.7 / Configure < prev    next >
Text File  |  1992-09-10  |  6KB  |  177 lines
  1. How to configure Mtools to your system...
  2.  
  3. 1) Things you'll need to know.
  4.  
  5.     The full path to the devices you want to use.
  6.  
  7.     The number of tracks, heads, and sectors supported by each device.
  8.  
  9.         5.25" 160k = 40 tracks, 1 head, and 8 sectors
  10.         5.25" 180k = 40 tracks, 1 head, and 9 sectors
  11.         5.25" 320k = 40 tracks, 2 heads, and 8 sectors
  12.         5.25" 360k = 40 tracks, 2 heads, and 9 sectors
  13.         5.25" 1.2m = 80 tracks, 2 heads, and 15 sectors
  14.         3.5"  720k = 80 tracks, 2 heads, and 9 sectors
  15.         3.5" 1.44m = 80 tracks, 2 heads, and 18 sectors
  16.  
  17.     If you choose to use a hard disk partition as one of your devices,
  18.     then you may have to change the read/write permissions on that
  19.     partition.
  20.  
  21. 2) The Makefile and msdos.h files
  22.  
  23.     The following pre-processor variables are used in Mtools.  They
  24.     should be set with "-Dvariable" in CFLAGS in the Makefile.
  25.  
  26.         BSD    for systems without System V style strings functions
  27.              or System V style utime().
  28.  
  29.         INT16    Machines with 16 bit integers such as XENIX 286.
  30.  
  31.     Pick one of the 3 following lock methods (if you have multiple
  32.     methods at your disposal, pick one in the following order).  If
  33.     a method is not chosen, record locking will not be performed.
  34.  
  35.         LOCKF    XENIX3 and SVR3.2 lock method
  36.  
  37.         FLOCK    Berkeley lock method
  38.  
  39.         FCNTL    Alternate Berkeley lock method (may not work
  40.             on devices)
  41.  
  42.     The folowing are pre-proccessor variables for the default device
  43.     setups for various flavors of Unix.  Pick one of the these, or
  44.     create a new entry in the devices.c file.
  45.  
  46.         ISC    default devices for ISC's SVR3.2
  47.  
  48.         UNIXPC    default devices for AT&T Unix PC 7300/3B1
  49.  
  50.         SPARC    default devices for SunOS 4.1 on a SPARCstation
  51.  
  52.         RT_ACIS    default devices for 4.3BSD on an IBM RT
  53.  
  54.         DELL    default devices for Dell's SVR4 and Merge
  55.  
  56.         XENIX    default devices for Xenix systems.
  57.  
  58.         SUN386    default devices for Sun's i386 machine
  59.  
  60.         RT_ACIS    default devices for IBM's BSD clone.        
  61.  
  62.         SPARC_ODD for reading odd-ball disks on a Sparc
  63.         
  64.     There is a variable in msdos.h called SIG_TYPE which should be
  65.     configured to the "base" return type of signal();
  66.  
  67.     The fat_read.c file has a preprocessor variable "CHK_FAT" that
  68.     can be undefined to turn off the fat encoding check if needed.
  69.  
  70. 3) The devices "database" in devices.c
  71.  
  72.     WARNING:  The devices.c file, as distributed, has *NO* devices
  73.     defined.  You *MUST* select from one of the examples or edit the
  74.     devices database yourself.
  75.  
  76.     struct device {
  77.         char drive;            /* the drive letter */
  78.         char *name;            /* full path to device */
  79.         long offset;            /* skip this many bytes */
  80.         int fat_bits;            /* FAT encoding scheme */
  81.         int mode;            /* any special open() flags */
  82.         int (*gioctl) ();        /* gioctl() if needed */
  83.         int tracks;            /* tracks */
  84.         int heads;            /* heads */
  85.         int sectors;            /* sectors */
  86.     };
  87.  
  88.     drive    the drive letter (in uppercase) that you want to associate
  89.         to this device.
  90.  
  91.     name    full path to the device.  Shell expansion is done on the
  92.         name so things like $HOME/vpix/C: will work.
  93.  
  94.     offset    skip over a partition table.  Useful for msdos disk "images"
  95.         such as those VP/ix uses.
  96.  
  97.     fat_bits The encoding scheme for the File Allocation Table.  Currently
  98.         supports only 12 and 16 bit FATs.  Hard disks usually use
  99.         16 bit FATs, while all diskettes use 12 bit FATs.
  100.  
  101.     mode    any special open() mode flags (not normally used, except
  102.         in the AT&T Unixpc 7300/3b1).
  103.  
  104.     gioctl    any special ioctl() calls required after opening the device
  105.         (not normally used, except in the AT&T Unixpc 7300/3b1).
  106.  
  107.     tracks    the number of tracks supported by this device or zero if
  108.         this type of sanity checking is not required.  Do NOT use
  109.         this field for hard disks or disk "images".  Also used by
  110.         gioctl(), if present, as a default starting place.
  111.  
  112.     heads    the number of heads supported by this device or zero if
  113.         this type of sanity checking is not required.
  114.  
  115.     sectors    the number of sectors supported by this device or zero if
  116.         this type of sanity checking is not required.
  117.  
  118.  
  119.     If a device supports more than one disk capacity (1.2m and
  120.     360k), then you should place the most frequently used capacity
  121.     first.  You may get an error message from the device driver when
  122.     the disk capacity doesn't match the device, but these can be
  123.     safely ignored.
  124.  
  125. 4)  Some example devices
  126.  
  127.     for Interactive 386ix 2.0.2 with:
  128.         1.2m 5.25" as a: (supports 1.2m, 360k, and 320k)
  129.         1.44m 3.5" as b: (supports 1.44m, 720k)
  130.         hard disk partition as c:
  131.         vpix disk image as d:
  132.         user's vpix disk image as e:
  133.  
  134.         {'A', "/dev/rdsk/f0q15dt", 0L, 12, 0, (int (*)()) 0, 80, 2, 15},
  135.         {'A', "/dev/rdsk/f0d9dt", 0L, 12, 0, (int (*)()) 0, 40, 2, 9},
  136.         {'A', "/dev/rdsk/f0d8dt", 0L, 12, 0, (int (*)()) 0, 40, 2, 8},
  137.         {'B', "/dev/rdsk/f13ht", 0L, 12, 0, (int (*)()) 0, 80, 2, 18},
  138.         {'B', "/dev/rdsk/f13dt", 0L, 12, 0, (int (*)()) 0, 80, 2, 9},
  139.         {'C', "/dev/rdsk/0p1", 0L, 16, 0, (int (*)()) 0, 0, 0, 0},
  140.         {'D', "/usr/vpix/defaults/C:", 8704L, 12, 0, (int (*)()) 0, 0, 0, 0},
  141.         {'E', "$HOME/vpix/C:", 8704L, 12, 0, (int (*)()) 0, 0, 0, 0},
  142.         {'\0', (char *) NULL, 0L, 0, 0, (int (*)()) 0, 0, 0, 0}
  143.  
  144.  
  145.     for AT&T Unixpc 7300/3b1 with:
  146.         360k 5.25" as a: (supports 360k, and 320k, 180k, 160k)
  147.         DOS73 disk image as c:
  148.  
  149.         {'A', "/dev/rfp020", 0L, 12, O_NDELAY, init_unixpc, 40, 2, 9},
  150.         {'C', "/usr/bin/DOS/dvd000", 0L, 12, 0, (int (*)()) 0, 0, 0, 0},
  151.         {'\0', (char *) NULL, 0L, 0, 0, (int (*)()) 0, 0, 0, 0}
  152.  
  153.  
  154.     for Sun SparcStation with:
  155.         1.44m 3.5" as a: (supports 1.44m and 720k)
  156.  
  157.         {'A', "/dev/rfd0c", 0L, 12, 0, (int (*)()) 0, 80, 2, 18},
  158.         {'A', "/dev/rfd0c", 0L, 12, 0, (int (*)()) 0, 80, 2, 9},
  159.         {'\0', (char *) NULL, 0L, 0, 0, (int (*)()) 0, 0, 0, 0}
  160.  
  161.         Note that the two devices are actually the same physical
  162.         device, and that only the number of sectors are
  163.         different.
  164.  
  165.     for Dell's SVR4 with:
  166.         5.25" 1.2m, 360k and 320k as a:
  167.         3.5" 1.44m, 720k as b:
  168.         dos partition as c:
  169.  
  170.         {'A', "/dev/rdsk/f0q15dt", 0L, 12, 0, (int (*) ()) 0, 80, 2, 15},
  171.         {'A', "/dev/rdsk/f0d9dt", 0L, 12, 0, (int (*) ()) 0, 40, 2, 9},
  172.         {'A', "/dev/rdsk/f0d8dt", 0L, 12, 0, (int (*) ()) 0, 40, 2, 8},
  173.         {'B', "/dev/rdsk/f13ht", 0L, 12, 0, (int (*) ()) 0, 80, 2, 18},
  174.         {'B', "/dev/rdsk/f13dt", 0L, 12, 0, (int (*) ()) 0, 80, 2, 9},
  175.         {'C', "/dev/rdsk/dos", 0L, 16, 0, (int (*) ()) 0, 0, 0, 0},
  176.         {'\0', (char *) NULL, 0L, 0, 0, (int (*)()) 0, 0, 0, 0}
  177.